home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / omniORB-2.5.0-src.tar.gz / omniORB-2.5.0-src.tar / omniORB_2.5.0 / README.FIRST < prev    next >
Text File  |  1998-03-09  |  7KB  |  201 lines
  1. This is the version 2.5.0 release of omniORB. We also refer to this version
  2. as omniORB2. 
  3.  
  4. The last public release is 2.4.0. For a summary of changes since the last
  5. release, please read the file CHANGES_250 . For a summary of changes from
  6. release 2.2.0 to 2.4.0, please see the file CHANGES_240.
  7.  
  8. omniORB2 is copyright Olivetti & Oracle Research Laboratory. It is free
  9. software. The programs in omniORB2 are distributed under the GNU General
  10. Public Licence as published by the Free Software Foundation. See the file
  11. COPYING for copying permission of these programs. The libraries in omniORB2
  12. are distributed under the GNU Library General Public Licence. See the file
  13. COPYING.LIB for copying permission of these libraries.
  14.  
  15. omniORB2 contains source code that is derived from the SunSoft OMG IDL
  16. Compiler Front End (CFE) version 1.3. The IDL CFE is copyright Sun
  17. Microsystems and is distributed here under the terms and conditions written
  18. in the file src/tool/omniidl2/COPYING.CFE.
  19.  
  20.  
  21. README files
  22. ============
  23.  
  24. README.win32 - contains important information on building and using omniORB2 
  25.                on Windows NT and Windows 95.
  26.  
  27. README.unix  - contains important information on building and using omniORB2
  28.                on Unix platforms.
  29.  
  30. README.openvms - contains important information on building and using omniORB2
  31.                on openVMS.
  32.  
  33. README.linux - contains further information on using omniORB2 on linux.
  34.  
  35. README.egcs  - contains information on building omniORB2 with egcs-1.0.
  36.  
  37. PORTING      - contains instructions on porting omniORB2.
  38.  
  39. CHANGES_250      - contains details of changes from 2.4.0 to 2.5.0.
  40.  
  41. CHANGES_240      - contains details of changes from 2.2.0 to 2.4.0.
  42.  
  43. IMPORTANT NOTE for users upgrading from 2.2.0: 
  44.         From release 2.4.0 onwards, the naming service uses the prefix 
  45.                 pragma "omg.org". This is introduced to bring our
  46.                 environment in line with the clarifications in the CORBA 
  47.                 specification. Unfortunately, this results in on-the-wire 
  48.                 incompatibility with clients that are linked with the old 
  49.                 library, i.e. any programs linked before version 2.4.0
  50.                 was released. Please read the installation instructions in 
  51.                 README.win32 or README.unix for details.
  52.  
  53.  
  54. Technical Highlights
  55. ====================
  56.  
  57. omniORB2 is an Object Request Broker (ORB) which implements
  58. specification 2.0 of the Common Object Request Broker Architecture (CORBA).
  59.  
  60. - C++ language bindings are supported. The mapping conforms to the latest
  61.   revision of the CORBA specification.
  62.  
  63. - The Internet Inter-ORB Protocol (IIOP) is used as the native protocol.
  64.  
  65. - The omniORB2 runtime is fully multithreaded. It uses native platform 
  66.   thread support encapsulated with a small class library, omnithread,
  67.   to abstract away from differences in native thread APIs.
  68.  
  69. - TypeCode and type Any are supported.
  70.  
  71. - A COS Naming Service, omniNames, is provided.
  72.  
  73. - The following platforms are supported:
  74.  
  75.   o Solaris 2.5/ Sun SparcCompiler C++ version 4.2
  76.   o Digital Unix 3.2/ DEC C++ compiler version 5.5
  77.   o Linux 2.0 (x86)/ GNU C++ compiler version 2.7.2 / Linuxthreads 0.5
  78.   o Windows NT / Windows 95 / Visual C++ version 5.0
  79.  
  80.   Ports to the following platforms are available. These ports are done by
  81.   external contributors and have been integrated into the source tree.
  82.   For these platforms, no pre-compiled binary is available.
  83.  
  84.   o IBM AIX 4.2/ IBM C Set++ 3.1.4
  85.   o HPUX 10.20/ aC++ (B3910 A.01.04)
  86.   o OpenVMS Alpha 6.2/ DEC C++ compiler 5.5  (UCX 4.1 ECO 8)
  87.   o OpenVMS Vax 6.1/ DEC C++ compiler 5.5  (UCX 4.0 ECO 1)
  88.   o NextStep 3.3/ gcc-2.7.2
  89.  
  90.   This release has also been tested with egcc-1.0 that has been patched to 
  91.   support thread-safe exception handling. See README.EGCS for details.
  92.  
  93.   The ports to Mac OS and SGI Irix 6.x are known to exist. However, the 
  94.   ports have not been merged into the source tree yet.
  95.  
  96.   It should be straightforward to port omniORB2 to any platform which
  97.   supports POSIX style threads, BSD style sockets and has a decent C++ 
  98.   compiler which supports exceptions.
  99.  
  100. - It has been tested for interoperability via IIOP with other ORBs, such as 
  101.   Iona Orbix 2.2 MT, Iona OrbixWeb 2.0.1, Visigenic Visibroker for C++,
  102.   and HP ORB Plus 2.5.
  103.  
  104. Work in progress
  105. ================
  106.  
  107. omniORB2 is not yet a complete implementation of the CORBA core. The
  108. following features are not supported in the current release. 
  109.  
  110. - The Dynamic Invocation Interface (DII) is not supported. 
  111.  
  112. - The Dynamic Skeleton Interface (DSI) is not supported. 
  113.  
  114.  
  115. Missing features
  116. ================
  117.  
  118. The following features are missing from omniORB2. 
  119. We are not currently planning on adding support for these features.
  120.  
  121. - The BOA only supports the persistent server activation policy. Other
  122.   dynamic activation and deactivation polices are not supported.
  123.  
  124. - omniORB2 does not has its own Interface Repository.
  125.  
  126.  
  127. Installation    
  128. ============
  129.  
  130. Installation instructions are provided in the following files:
  131.  
  132. - README.unix  for all unix platforms
  133. - README.win32 for Windows NT and Windows 95
  134.  
  135.  
  136. Documentation
  137. =============
  138.  
  139. - omniORB2 user guides are located in the ./doc directory. They are 
  140.   available in latex, postscript, acrobat and html formats.
  141.  
  142. - Man pages for the programs in this distribution are located in
  143.   ./man directory.  
  144.  
  145. - README files are provided throughout the distribution tree. They provide
  146.   specific information about the directories and files, tools and examples.
  147.   You may want to explore the tree to become familiar with the information
  148.   provided in the README files.
  149.  
  150.  
  151. Examples
  152. ========
  153.  
  154. - Example programs that demonstrate the use of omniORB2 are located in
  155.   ./src/examples. 
  156.  
  157.  
  158. Recommended Additional Documentation
  159. ====================================
  160.  
  161. omniORB2 is based on the following OMG specifications. 
  162.  
  163. - The Common Object Request Broker: Architecture and Specification. The
  164.   current version is available on-line at 
  165.          http://www.omg.org/corba/corbiiop.htm
  166.  
  167.   In particular, omniORB2 users will find chapter 3 "OMG IDL Syntax and
  168.   Semantics" and chapter 16 "Mapping of OMG IDL to C++" particularly
  169.   relevant.
  170.  
  171. - The COS Naming Service Specification. The current version is available
  172.   on-line at 
  173.           http://www.omg.org/corba/sectrans.htm
  174.   
  175.  
  176. Contact
  177. =======
  178.  
  179. If you have any queries, suggestions and problems in using omniORB2,
  180. contact omniorb@orl.co.uk. We'd like to hear from you.
  181.  
  182. The latest version of omniORB2 is available from our Web pages:
  183.  
  184.          http://www.orl.co.uk/omniORB/omniORB.html
  185.  
  186. There is also a mailing list: omniorb-list@orl.co.uk. 
  187.  
  188. This list carries announcements of new releases and provides a forum for
  189. omniORB2 users and developers to discuss the usage and future development
  190. of omniORB2.
  191.  
  192. If you want to add yourself to this mailing list, send the following command
  193. in the body of your email to "omniorb-list-request@orl.co.uk":
  194.  
  195.      subscribe
  196.  
  197.  
  198. The archives of the mailing list are available at:
  199.  
  200.          http://www.orl.co.uk/omniORB/archives/
  201.